PATH Mac OS 8 and 9 Developer Documentation > Text and Other International Services > Apple Type Services for Unicode Imaging (ATSUI) > Apple Type Services for Unicode Imaging Reference
     

ATSUCreateStyle

Creates a style object.

OSStatus ATSUCreateStyle (ATSUStyle *oStyle);
oStyle
A pointer to a reference of type ATSUStyle. On return, the newly-created style object. You cannot pass NULL for this parameter.

function result
A result code. See Result Codes.
DISCUSSION
The ATSUCreateStyle function creates an "empty" style object that contains default style run attribute, font feature, and font variation values. The default font feature and variation values are defined by the font; default style attribute values are described in Table C-1. You can set the style run attribute values in a style object by calling the function ATSUSetAttributes. To set font features and font variations in a style object, call the functions ATSUSetFontFeatures and ATSUSetVariations, respectively.

To create a copy of an existing style object, call the function ATSUCreateAndCopyStyle. You can copy a portion of a style object into an existing style object by calling the functions ATSUCopyAttributes, ATSUOverwriteAttributes, and ATSUUnderwriteAttributes.

SPECIAL CONSIDERATIONS
ATSUCreateStyle allocates memory in your application heap, unless you designate a different heap by calling the function ATSUCreateMemorySetting.

VERSION NOTES
Available beginning with ATSUI 1.0.

© 2000 Apple Computer, Inc. – (Last Updated 25 Jan 00)